gtkassistant: Minor docstring wording changes
authorHolger Knust <holger@knust.us>
Sat, 15 Aug 2020 09:20:03 +0000 (05:20 -0400)
committerHolger Knust <holger@knust.us>
Sat, 15 Aug 2020 09:20:03 +0000 (05:20 -0400)
Changed the wording to improve the clarity of the documentation. Fixed grammar issue ("spllited")

gtk/gtkassistant.c

index b776fbabbade737a5e81ae3782ad6c72e50f6524..ebe6b8e4f319db9ecfddeabf845241e00947cec4 100644 (file)
  * @Title: GtkAssistant
  *
  * A #GtkAssistant is a widget used to represent a generally complex
- * operation splitted in several steps, guiding the user through its
- * pages and controlling the page flow to collect the necessary data.
+ * operation split up into several steps. Each step consists of one or more
+ * pages. GtkAssistant guides the user through the pages, and controls 
+ * the page flow to collect the data needed for the operation.
  *
- * The design of GtkAssistant is that it controls what buttons to show
- * and to make sensitive, based on what it knows about the page sequence
- * and the [type][GtkAssistantPageType] of each page,
- * in addition to state information like the page
+ * GtkAssistant handles which buttons to show and to make sensitive based 
+ * on page sequence knowledge and the [type][GtkAssistantPageType] 
+ * of each page in addition to state information like the 
  * [completion][gtk-assistant-set-page-complete]
- * and [committed][gtk-assistant-commit] status.
+ * and [committed][gtk-assistant-commit] page statuses.
  *
  * If you have a case that doesn’t quite fit in #GtkAssistants way of
  * handling buttons, you can use the #GTK_ASSISTANT_PAGE_CUSTOM page